home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / spiele / think / doubletris / doubletris.dok < prev    next >
Text File  |  1996-07-10  |  19KB  |  419 lines
  1. $VER:Doubletris 1.01 (11.07.1996)
  2.  
  3.                           ***************************
  4.                           *                         *
  5.                           *   D O U B L E T R I S   *
  6.                           *                         *
  7.                           ***************************
  8.  
  9. WAS IST DAS?
  10.  
  11.   Doubletris ist ein Tetris-Clone für zwei Spieler, die simultan in einem
  12. Spielfeld spielen können/müssen. Desweiteren gibt es einen Computerspieler,
  13. der aber lausig spielt. Doubletris ist nicht nur multitaskingfähig, es
  14. läuft gar nicht ohne.
  15.  
  16. DEKLARATION
  17.  
  18.   Da ich Doubletris aus einer bestehenden Idee nur weiterentwickelt habe,
  19. gebe ich dieses Programm in die FREEWARE. (Copyright siehe unten.)
  20.  
  21. EINFÜHRUNG UND INTENTION
  22.  
  23.   Ich habe Doubletris vor etwa drei Jahren begonnen, da ich im
  24. Informatik-Unterricht die objektorientierte Sprache Oberon-2 kennengelernt
  25. habe. Die Natur dieser Sprache lies mich schnell über eine nahezu
  26. vollkommen objektorientierte Fassung nachdenken und schließlich habe ich
  27. diese im Winter '93 kurz vor meinem Abitur begonnen. Bei der Entwicklung
  28. mußte ich manche herbe Enttäuschung einstecken. So waren mir manchmal der
  29. Sinn und Zweck einiger Restriktionen von Oberon nicht ganz einleuchtend.
  30. Aber endlich ist es vollbracht.
  31.  
  32. SYSTEMVORRAUSSETZUNG
  33.  
  34.   Doubletris wurde entwickelt mit folgender Systemconfiguration:
  35.  
  36. A500 1MB Chip ECS Kickstart 1.3, 2.04 (WB 2.1), 3.1
  37. A590 SCSI-Controller, 1MB Fast-Ram, 120MB Quantum-HD,
  38. Toshiba XM4101 CD-Rom, Mikronik-Mini-Tower
  39. zeitweilig mit Harms 030-Turbokarte :-((
  40.  
  41.   Doubletris wurde getestet auf folgenden Systemen:
  42.  
  43. s. o.
  44. A500 1MB Chip 8MB Fast G-Force 040 (von M-Tec) 1080 MB IBM, Toshiba 3601
  45.      Kick 3.1
  46. A500 1MB Chip 8MB Fast GVP-SerieII-SCSI-Controller 127MB Quantum OS2.1
  47.      Harms 030+ PC-Karte
  48. A2000 1MB Chip 6MB Fast A2630 Apollo-HD-Controller Tandem-AT-Controller
  49.      Retina-Grafikkarte 120MB-HD AT-Karte
  50. A2000 1MB Chip 5MB Fast GVP-SerieII-SCSI-Controller 270MB-HD OS2.1
  51.      PC-Karte
  52.  
  53.   Mindest Systemconfiguration:
  54.  
  55. Amiga mit 512KByte Ram OS1.2 (Wurde nicht getestet, sollte aber laufen.)
  56. Ich empfehle einen Amiga mit OS2.04. Er sollte 1MB Ram haben, um die
  57. Sound-module sofort laden zu können.
  58.  
  59.  
  60. (ERSTER) START
  61.  
  62.   Beim ersten Start sollte unter KS2.04+ ein Screenmode-Requester
  63. auftauchen. (Sollte dies nicht der Fall sein sehen sie im
  64. Tooltypes-Abschnitt unter SCREENMODE nach.) Hier sollten Sie ihre
  65. bevorzugte Bildschirmauflösung einstellen. Danach erscheint auf einem
  66. schwarzen Bildschirm, die Meldung "Trying to load all sound-modules (for
  67. speed)!". Doubletris versucht jetzt alle in den Tooltypes angegebenen
  68. Soundmodule zu laden. (Aus rechtlichen Gründen werden keine Soundmodule
  69. mitgeliefert.) Danach erscheint ein Menü.
  70.  
  71. MENUE
  72.  
  73.   Das Menü ist die Schaltzentrale von Doubletris. Von hier können alle das
  74. Spiel direkt beeinflussenden Optionen eingestellt werden. Die Icons haben
  75. folgende Bedeutung.
  76.  
  77.                     DOUBLETRIS
  78.             (Enthält nur Producer-Infos.)
  79.  
  80.  
  81.   CPU            PL1          Joystick        Maus         Tastatur
  82.  
  83. Der Computer  Menschlicher    Eingabeeinheit die der 1.Spieler benutzt
  84. spielt als    Spieler         In Port 1      In Port 1     s.u. (*)
  85. Spieler 1.
  86.  
  87.   CPU            PL2          Joystick        Maus         Tastatur
  88.  
  89. Der Computer  Menschlicher    Eingabeeinheit die der 2.Spieler benutzt
  90. spielt als    Spieler         In Port 2      In Port 2     s.u. (**)
  91. Spieler 2.
  92.                                 |  zur Auswahl mit Tastatur (***)
  93.                                \|/
  94.   FX             Musik        Start           Exit         Highscore
  95.  
  96. Schaltet      Schaltet Musik                               Gibt die
  97. Geräusche     ein.                                         aktuellen
  98. ein. (****)   (****)                                       Highscores aus
  99.  
  100. (*) Steuertasten für Spieler 1
  101.     Cursortasten
  102.     links                            =  Element nach links
  103.     rechts                           =     "       "  rechts
  104.     unten                            =     "       "  unten
  105.     0 auf numerischem Tastaturblock  =  Drehen
  106.  
  107. (**) Steuertasten für Spieler 2
  108.      y      =  Element nach links
  109.      x      =     "       "  rechts
  110.      c      =     "       "  unten
  111.      Space  =  Drehen
  112.  
  113. (***) Dieser Pfeil kann über die Tastatur gesteuert werden, wobei die
  114.       Cursortasten steuern und Space und Return auswählen.
  115.  
  116. (****) Die Musikmodulabspielroutinen wurden von OctaMed(s. MUSIK UND FX)
  117.        importiert. Sie sperren alle Soundkanäle, weswegen es mir nicht
  118.        möglich ist systemkonform Geräusche abzuspielen.
  119.  
  120.   Unmögliche Kombinationen der Icons können nicht angewählt werden,
  121. so ist die gleichzeitige Deaktivierung beider Spieler nicht möglich.
  122.  
  123. Beispiel:
  124.   Wenn Sie z. B. mit einer Maus in Port 2 alleine spielen möchten so
  125. deaktivieren Sie das PL1-Feld durch anklicken (deaktiviert heißt
  126. durchgestrichen) und aktivieren Sie in Zeile zwei das Feld mit der Maus.
  127. Danach klicken sie auf Start und das Spiel beginnt.
  128.  
  129. DAS SPIEL
  130.  
  131.   Der Bildschirm ist in mehrere Teile unterteilt.
  132.  
  133.                        |                        |
  134.     -----------        |                        |         -----------
  135.    |           |       |                        |        |           |
  136.    |           |       |                        |        |           |
  137.    |  Preview  |       |                        |        |  Preview  |
  138.     -----------        |                        |         -----------
  139.          ^             |                        |              ^
  140.   nächstes Element     |                        |     nächstes Element
  141.     für Spieler 1      |        Spielfeld       |      für Spieler 2
  142.                        |                        |
  143.                        |                        |
  144.                        |                        |
  145.                        |                        |
  146.                        |                        |
  147.                        |                        |
  148.                        |                        |
  149.                        |                        |
  150.                        |                        |
  151.                        |                        |
  152.                        |                        |
  153.                        |                        |
  154.    Statistik für       |                        |   Statistik für
  155.      Spieler 1         |                        |     Spieler 2
  156. -------------------------------------------------------------------------
  157.  Player1 :             |  Alltogether:          |  Player2 :
  158.                        |                        |
  159.  000000000000          |  0000000000000         |  000000000000
  160. -------------------------------------------------------------------------
  161.         ^                      ^                          ^
  162.  Punkte von Spieler 1   Punkte von Spieler 1+2     Punkte von Spieler 2
  163.                         beim Zweispielerspiel
  164.                         addiert
  165.  
  166.   Das Hauptaugenmerk wird sich beim Spiel auf das Spielfeld richten. Die
  167. Teile können je nach gewählter Steuereinrichtung mit dem
  168. Joystick-/Mausknopf und der Drehtaste (s.o.) im Uhrzeigersinn gedreht
  169. werden. Nach links oder rechts wird das Element durch eine Bewegung des
  170. Eingabegeräts in die entsprechende Richtung bewegt. Nach unten ziehen
  171. bewirkt eine Beschleunigung des Elements.
  172.  
  173. Punkteverteilung:
  174. Jedes neue Element bringt einen Punkt.
  175. Jede Zeile, die vollständig gefüllt ist, wird gelöscht und bringt dem
  176. jeweiligen Spieler 10 Punkte.
  177. Werden 2 Zeilen auf einmal gelöscht, gibt es 30 Punkte.
  178. Werden 3 Zeilen gelöscht, gibt es 60 Punkte und
  179. werden gar vier Zeilen gelöscht, gibt es 100 Punkte.
  180.  
  181.   Hier gilt : Probieren geht über studieren.
  182.  
  183. TASTEN IM SPIEL
  184.  
  185.   Während des Spiels lösen einige Tasten besondere Funktionen aus:
  186.  
  187. P   - Pause = Versetzt das Spiel in den Pausezustand. Alle Farben werden
  188.               grau geschaltet und nach der ersten Mausbewegung ist auch
  189.               ein Mauszeiger zu sehen. Doubletris ist nicht nur
  190.               multitaskingfähig, es baut sogar darauf auf. Sie können also
  191.               ein Bild in einem Raytracer berechnen und gleichzeitig
  192.               Doubletris spielen ohne während des Spiels Doubletris
  193.               verlassen zu müssen, um nach dem Raytracer zu sehen. Ein
  194.               Druck auf linke Amiga und N genügt und sie sind auf einem
  195.               anderen Screen. Ein Klick auf den Doubletris-Bildschirm
  196.               reaktiviert das Spiel sofort.
  197.  
  198. M   - Musik = Schaltet die Musik an bzw aus. Soll die Musik eingeschaltet
  199.               werden, wenn die Geräusche aktiviert sind, werden diese
  200.               abgeschaltet. Sollte ihnen die Musik nicht gefallen, können
  201.               Sie durch zweimaliges drücken auf "M" den Computer dazu
  202.               veranlassen ein anderes Musikstück auszuwählen.
  203.  
  204. F   - FX    = Schaltet die Geräusche ein bzw. aus. Sollte ein Musikstück
  205.               spielen, wenn die Geräusche eingeschaltet werden sollen, 
  206.               wird dieses automatisch gestopt.
  207.  
  208. Esc - Stop  = Beendet das Spiel.
  209.  
  210. Help- Hilfe = Schaltet die Vorschau(Preview)-Funktion von Doubletris ein
  211.               bzw. aus. Im Gegensatz zu anderen Tetrisspielen hat die
  212.               Preview-Funktion keinen Einfluß auf die Punktevergabe.
  213.  
  214. TOOLTYPES
  215.  
  216.   Doubletris benutzt einige Tooltypes um interne Voreinstellungen zu
  217. verändern. Nach folgenden Tooltypes wird gesucht:
  218.  
  219.   SCREENMODE   - Dieses Tooltype wird von Doubletris beim ersten Start auf
  220.    =xxxxxxxxH    Systemen mit Kickstart 2.04 oder höher nach Anwahl eines
  221.                  Screenmodes selbst erzeugt. Es gibt einen Schlüssel für
  222.                  den gewählten Screenmode in dem Doubletris jetzt immer
  223.                  starten wird wieder. Dieses Feld sollten Sie nie von Hand
  224.                  edieren, wenn Sie nicht ganz genau wissen was sie tun.
  225.                  Möchten sie den Screenmode von Doubletris ändern, so
  226.                  löschen sie diesen Eintrag aus den Tooltypes. Es erscheint
  227.                  dann beim nächsten Start wieder der Screenmode-Requester.
  228.                  Zu beachten ist auch der Zustand des SPRITES-Tooltype,
  229.                  dies macht nur bei einem PAL oder NTSC-monitor Sinn. Auf
  230.                  allen anderen Auflösungen liefert es Müll.
  231.  
  232.   SPRITES      - Gibt an, ob für die Darstellung der Elemente
  233.    =ON/OFF       Hardware-sprites benutzt werden sollen oder nicht. Da
  234.                  manche Grafikmodi oder Grafikkarten keine Hardware-sprites
  235.                  unterstützen, kann hiermit auf eine konventionelle
  236.                  Darstellungsmethode umgeschaltet werden. Der Nachteil:
  237.                  Die Elemente fangen auf langsamen Maschinen an zu
  238.                  flickern, da sie kurz ganz gelöscht werden, um dann wieder
  239.                  dargestellt zu werden. Testen sie welcher Modus am
  240.                  angenehmsten ist und/oder funktioniert.
  241.  
  242.   FX           - Hiermit kann von Anfang an eingestellt werden, ob die
  243.    =ON/OFF       Geräusche benutzt werden. Die Musik hat Vorrang vor den
  244.                  Geräuschen, wenn also das folgende Tooltype auch angegeben
  245.                  wurde und die Module geladen werden konnten. Wird die
  246.                  Musik gespielt.
  247.  
  248.   MUSIC        - Schaltet die Musik von Anfang an ein oder aus. Nur wenn
  249.    =ON/OFF       keine Module angeben werden, wird auch keins geladen. Ein
  250.                  'MUSIC=OFF' bewirkt also nicht, daß die Module nicht
  251.                  geladen werden.
  252.  
  253.   INTROMODULE  - Gibt das bei der Menüdarstellung abzuspielende Musikstück
  254.    =name         an. (siehe auch MUSIK UND FX)
  255.  
  256.   MAINMODULEx  - Gibt eins der Module an, die beim Spiel abgespielt werden.
  257.    =name         x steht dabei für eine Zahl zwischen 1 und 5, die angibt
  258.                  welches Module welche Nummer hat. Da die Tooltypes alle
  259.                  unterschiedlich sein müssen, mußte ich auf dieses
  260.                  Verfahren zurückgreifen. Effektiv ist es egal in welcher
  261.                  Reihenfolge die Musikstücke angegeben werden, sie werden
  262.                  intern sowieso neu sortiert. (siehe auch MUSIK UND FX)
  263.  
  264.   ENDMODULE    - Hier gilt das gleiche wie bei INTROMODULE. Nur das dieses
  265.    =name         Modul am Spielende abgespielt wird. (siehe auch MUSIK UND FX)
  266.  
  267.   PREVIEW      - Hiermit kann voreingestellt werden, ob die Vorschau aktiv
  268.    =ON/OFF       sein soll.
  269.  
  270.   (WINDOW)     - Dieses Tooltype hat keine Bedeutung für Doubletris. Es
  271.                  wird von einem Laufzeitsystem der Programmiersprache
  272.                  benutzt, um ein Fenster zu öffnen in dem Fehlermeldungen
  273.                  ausgegeben werden können. Diese Tooltype habe ich nur
  274.                  angeben, um Besitzern von Snoopdos :-) schlaflose Nächte
  275.                  zu ersparen.
  276.  
  277.   Bei den Tooltypes bedeutet =ON/OFF ein Boolean Tooltype, daß nur die zwei
  278. Werte ON(Ja) oder OFF(Nein) annehmen kann. Weiterhin ist für ON auch noch
  279. YES und für OFF NO gestattet.
  280.  
  281.  =name bedeutet, daß hier ein Dateiname angeben werden kann. Dieser kann
  282. absolut oder relativ sein, daß ist Doubletris egal. Für alle, denen absolute
  283. und relative Pfade nichts sagen, hier ein paar Beispiele:
  284.  
  285. //Sounds/mod.Hello  relativ
  286. df0:test            absolut
  287. dh0:trashcan/test   absolut
  288. Mod.IntroModule     relativ
  289.  
  290. MUSIK UND FX
  291.  
  292.   An einem bestimmten Entwicklungszeitpunkt wurde mir klar, daß Doubletris 
  293. nicht stumm bleiben konnte. Also habe ich mich nach Möglichkeiten umgesehen,
  294. um mit möglichst wenig Aufwand Musikmodule abzuspielen. Dabei bin ich auf
  295. OctaMed gestoßen. Dieses bot Routinen an, die freivertreibbar waren und es
  296. dem Programmierer ziemlich einfach machten Musik abzuspielen. DANKE!
  297. Als kleiner Nachteil bleibt aber, daß es dadurch unmöglich wurde Effekte und
  298. Musik zu gleich abzuspielen. Ich finde, daß man das aber verschmerzen kann.
  299. Wie kann man nun eigenen Musikmodule in Doubletris einbringen?
  300.   Doubletris lädt Musikmodule, die in den Tooltypes angeben sind, nach.
  301. Diese Module müssen als sogenannte MED-Files abgespeichert sein. Das sind
  302. die meisten Musikmodule NICHT. Es gibt aber eine Möglichkeit diese zu
  303. konvertieren. Besorgen sie sich OctaMed V2.00 (Fish 840) laden sie das
  304. Musikmodul, daß sie konvertieren wollen. Speichern sie es. OctaMed fragt
  305. dann in einem kleinen Menü in welchem Format er speichern soll. Wählen sie
  306. hier 'MED-Module'. Speichern sie das Modul an einem Ort an dem Doubletris
  307. es erreichen kann. Ändern sie dann den Namen in einem Tooltypefeld. Beachten
  308. sie das Copyright des Modulherstellers.
  309.  
  310.   Um Copyright-problemen mit den Autoren bestimmter Module zu vermeiden,
  311. habe ich mich entschlossen keine Module mitzuliefern, es kann jedes
  312. MED-Modul benutzt werden, es muß nur nach obigen Schema konvertiert werden.
  313.  
  314. HIGHSCORES
  315.  
  316.   Die Highscores werden nur bei einer Veränderung am Ende des Spiels
  317. gespeichert. Sie werden in die Datei Doubletris.HC gespeichert, die sich im
  318. selben Verzeichnis wie Doubletris befinden muß.
  319.  
  320. Zur Darstellung:
  321.   Bei vielen, die Doubletris zum erstenmal sehen, entsteht hier
  322. Verwunderung warum drei Tabellen angezeigt werden. Ganz einfach! Man kann
  323. mit Doubletris Ein- und Zweispieler-Spiele machen. Bei einem
  324. Zweispieler-Spiel wird die einzelne Leistung jedes Spielers gewertet und
  325. die Summe der beiden Spieler.
  326.  
  327. RECHTLICHES
  328.  
  329.   Ich übernehme keine Haftung für alle Schäden die Doubletris anrichtet.
  330. Wenn es ihre Festplatte formatiert, so ist das ihre Schuld, da man ein
  331. unbekanntes Programm nicht auf seine Festplatte losläßt (nicht wahr Albi?).
  332. Desweiteren übernehme ich keine Haftung dafür, daß das Spiel funktioniert
  333. und überhaupt sinnvoll einsetzbar ist.
  334.  
  335.   Doubletris ist Freeware. Das Copyright des Original Tetris bleibt
  336. gewahrt. Das Copyright von Doubletris liegt bei Andre Vehreschild.
  337.  
  338.   WICHTIG !!
  339.  
  340.   Doubletris darf nur auf folgenden PD-Serien vertrieben werden:
  341. Fish-Serie speziel auf den FreshFish-CDs,
  342. SaarAG/Amok und auf deren CDs,
  343. desweiteren darf Doubletris im Aminet und auf deren CDs verteilt werden.   
  344. Die Weitergabe auf Diskette ist nur gestattet, wenn die Kosten für die
  345. Weitergabe nicht mehr als 5.-DM betragen.
  346.  
  347. QUELLTEXT
  348.  
  349.   Doubletris wurde in Oberon-2 mit Hilfe von AmigaOberon3.2 der A+L Ag
  350. entwickelt. Weiterhin haben an der Entwicklung der A68k, MICE, OctaMed
  351. sowie PPaint mitgewirkt.
  352.  
  353.   Doubletris wurde zu 99% objektorientriert geschrieben.
  354.  
  355.   Es besteht aus 28 Modulen, 170 KByte Quelltext und ungefähr 6100 Zeilen.
  356.  
  357.   Wer den Sourcecode habe möchte, kann einen frankierten Rückumschlag mit
  358. einer Diskette an meine Adresse schicken. Bitte schreiben Sie dabei was sie
  359. haben wollen. Wenn der Amok-Verein mitspielt, wird der Sourcecode auch in
  360. dieser Serie erscheinen. Also Augen auf bevor Sie Geld ausgeben.
  361.  
  362. FEHLER
  363.  
  364. Symtom              | Abhilfe
  365.                     |
  366. Doubletris startet  | Doubletris benötigt die icon.library im
  367. nicht.              | LIBS:-verzeichnis.
  368.                     |
  369. Der Screenmode-     | Der Screenmoderequester wird erst ab Kickstart 2.0
  370. requester kommt     | eingesetzt, dafür muß die asl.library im LIBS:-
  371. nicht.              | Verzeichnis sein.
  372.                     |
  373.                     | Das Tooltype SCREENMODE existiert. Löschen Sie es
  374.                     | und Doubletris präsentiert einen neuen Screenmode-
  375.                     | requester.
  376.                     |
  377. Die Bildschirm-     | Es wurde ein Screenmode eingestellt den ihr Monitor
  378. darstellung ist     | nicht unterstützt. Löschen Sie das Tooltype
  379. nicht zu lesen.     | SCREENMODE.
  380.                     |
  381. Die Elemente sind   | Der Grafikmodus unterstützt keine Hardware-sprites.
  382. nicht zu sehen.     | Setzen Sie das Tooltype SPRITES auf OFF.
  383.                     |
  384. Die Sound-module    | Die Sound-module befinden sich nicht an der Stelle,
  385. wurden nicht        | die die Tooltypes angeben. Wenn Doubletris ein
  386. geladen.            | Modul nicht finden kann so gibt es eine Beschreibung
  387.                     | des Problems aus.
  388.                     | "Can't find xxx." bedeutet , daß dieses Modul nicht
  389.                     | gefunden werden konnte. Kontrolieren Sie deshalb den
  390.                     | in den Tooltypes angegebenen Pfad.
  391.                     |
  392.  
  393. ADRESSE
  394.  
  395.   Meine Adresse ist:
  396.  
  397.   Andre Vehreschild
  398.   Kaiser-Wilhelm-Allee 4
  399.   47551 Bedburg-Hau
  400.   Deutschland
  401.  
  402.   e-mail: vehre@pool.informatik.rwth-aachen.de
  403.  
  404. GRÜßE UND DANK
  405.  
  406.   Grüße gehen an Gott und die Welt.
  407.  
  408.   Desweiteren geht Dank an Michael Albrecht für seine ständige Hilfe und
  409. die Bereitschaft eine hochgejagte Leiterbahn wieder zu flicken, an meinen
  410. Vetter, Klaus Vehreschild, ohne den sich die Elemente wahrscheinlich
  411. immernoch nicht korrekt drehen würden, an meinen Informatik-Lehrer Werner
  412. Ueding für seinen Unterricht in Oberon-2 und die konsequente Einhaltung der
  413. Objektorientierung, an die Betatester für ihren Mut dieses Programm auf ihre
  414. Festplatten zu lassen.
  415.  
  416. TSCHAU !
  417.  
  418.   Amiga for ever. :-)
  419.